home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / cli / waitnotify-1.1.lha / WaitNotify / WaitNotify.doc < prev    next >
Encoding:
Text File  |  1994-12-14  |  2.1 KB  |  61 lines
  1. WaitNotify                                                         WaitNotify
  2.  
  3.    NAME
  4.     WaitNotify -- Wait for a file or directory modification
  5.  
  6.    SYNOPSIS
  7.     WaitNotify NAME/A/M,QUIET/S,FMT=FORMAT/K
  8.  
  9.    FUNCTION
  10.     WaitNotify posts a notification request on the given files
  11.     or directories.  The command will not return until at least
  12.     one of them has been modified.  For files, it will return
  13.     after the file is closed.
  14.  
  15.     The optional format string will be printed when the file or
  16.     directory changes.  The first "%s" in it will be replaced by
  17.     the name.
  18.  
  19.    INPUTS
  20.     NAME          - name of the files or directories which you want
  21.             to observe
  22.     QUIET         - suppresses warnings and error messages (but sets
  23.             the return value to allow later diagnostis
  24.     FORMAT        - string to print on exit.
  25.  
  26.    EXAMPLES
  27.     ;Wait for a change in our startup-sequence
  28.     WaitNotify S:Startup-Sequence
  29.  
  30.     ;Wait for a change in either startup script and report its name
  31.     WaitNotify S:Startup-Sequence S:User-Startup FMT="%s*N"
  32.  
  33.     ;Show the first file which changes via More
  34.     More `WaitNotify S:Startup-Sequence S:User-Startup FMT=%s`
  35.  
  36.    BUGS
  37.     Not all    filesystems will support file notification. In particular,
  38.     most network filesystems won't support it.
  39.  
  40.  
  41.    DISCLAIMER
  42.     This file is part of the WaitNotify distribution.
  43.  
  44.     WaitNotify is free software; you can redistribute it and/or modify
  45.     it under the terms of the GNU General Public License as published
  46.     by the Free Software Foundation; either version 1 of the License,
  47.     or (at your option) any later version.
  48.  
  49.     WaitNotify is distributed in the hope that it will be useful,
  50.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  51.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  52.     See the GNU General Public License for more details.
  53.  
  54.     You should have received a copy of the GNU General Public License
  55.     along with the program; see the file COPYING.  If not, write to
  56.     the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  57.  
  58.    COPYRIGHT
  59.     WaitNotify is Copyright (C)1994 by Tobias Ferber.
  60.     You can reach me via E-mail: ukjg@rz.uni-karlsruhe.de
  61.